home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / gdesk45.zip / GIFDESK.DOC next >
Text File  |  1993-01-01  |  12KB  |  227 lines
  1.           GIFDESK.DOC - some notes on GIFDESK.EXE 4.5
  2.        (released January, 1993 - 27th anniversary of "Rubber Soul")
  3.  
  4. GIFDESK is a utility to view many of your GIFs at one time on a VGA system.
  5. Examples of how to use GIFDESK:
  6.     GIFDESK *.gif
  7.     GIFDESK f:\pics\s*.gif p*.gif
  8.  
  9. Run GIFDESK alone to get a quick-reference to it's usage.
  10.  
  11. Remember, you need at least a VGA to use GIFDESK!  All of the Super VGA
  12. modes require at least 512k video memory. If you have only 256k, you
  13. may need to override the autodetect by setting GIFDESK=VGA at DOS prompt.
  14. ------------------------------------------------------------------------------
  15. NEW THIS VERSION:
  16.     - HiColor Support. Really makes improvement. (added version 4.3)
  17.       will use 640x480x32k and 800x600x32k from VESA driver.
  18.       (These are modes 0x110 and 0x113 on the Speedstar 24x VESA driver)
  19.     - VESA bug fixed for cards returning more than 256 bytes of info.
  20. ------------------------------------------------------------------------------
  21. Display:  GIFs are displayed by GIFDESK in several arrangements.  The
  22. maximum number of GIFs shown at one time is 80 (if you have a 1024x768
  23. mode on your SVGA).  GIFDESK can also show 1 GIF at a time (in color if
  24. you have a hi-res 256 color mode on your SVGA).  The display layout can
  25. be changed by hitting the SPACEBAR.  This will cycle through the various
  26. GIF arrangements.  Also, the F1,F2,F3 and F4 keys will switch directly
  27. to a particular layout.  (Notice that F1=1x1, F2=2x2, etc).  If you are
  28. using an SVGA that supports an 640x480, 800x600 and/or 1024x768 mode you
  29. can switch to a higher resolution using the + key.  Switch to lower
  30. resolution with the - key.  The following table lists the various
  31. configurations:
  32.  
  33. Video Mode                              GIF Arrangemant
  34.               F1 Key         F2 Key       F3 Key       F4 Key
  35. ------------------    -------------  -----------  -----------  ------------
  36. 640x480x16            1x1 16-Grey    2x2 16-Grey  3x3 16-Grey  6x5  16-Grey
  37. 640x480x256 (SVGA)    1x1 256/64     2x2 256/64   3x3 256/64   6x5  256/64
  38. 640x480x32k (SVGA)    1x1 32k        2x2 32k      3x3 32k      6x5  32k
  39. 800x600x16  (SVGA)    1x1 256/64     2x2 256/64   4x4 256/64   8x6  256/64
  40. 800x600x256 (SVGA)    1x1 256/64     2x2 256/64   4x4 256/64   8x6  256/64
  41. 800x600x32k (SVGA)    1x1 32k        2x2 32k      4x4 32k      8x6  32k
  42. 1024x768x16 (SVGA)    1x1 256/64     2x2 256/64   5x5 256/64   10x8 256/64
  43. 1024x768x256(SVGA)    1x1 256/64     2x2 256/64   5x5 256/64   10x8 256/64
  44.  
  45. (256/64 is 256 colour or 64 grey - toggle between these with F10)
  46.  
  47. Notes:
  48.     1) GIFDESK should be able to handle GIF's up to 4096x4096 in size.
  49.     2) Writing a GIF file (via . key) may take a while.  As it is being
  50.        done, a white dot will scan the screen for top to bottom.  At
  51.        completion, a two tone sound will occur if successful.
  52.     3) Printing a screen (via F9 key) may take a while. At completion
  53.        a tone will occur.
  54.  
  55. Super VGA's:
  56. If you have a super VGA that supports 640x480x256 or better (you need 512K),
  57. GIFDESK should use the appropriate driver for your card.  The signon screen
  58. lists the type of card that GIFDESK detected.  If this is incorrect, you can
  59. override this autoselection with the environment variable GIFDESK. Set the
  60. environment variable GIFDESK to the correct card name according to the following
  61. table:
  62.  
  63.   Card(s)                          GIFDESK Environment Variable
  64.   =====================================================================
  65.   ATI VGA Wonder                   ATI
  66.   ---------------------------------------------------------------------
  67.   Chips & Technologies, Cardinal   C&T
  68.   Boca Research 1024 VGA
  69.   ---------------------------------------------------------------------
  70.   Everex Viewpoint                 EVEREX
  71.   ---------------------------------------------------------------------
  72.   Paradise, AST, Compaq, Dell      PARADISE
  73.   Western Digital
  74.   ---------------------------------------------------------------------
  75.   Tseng, Genoa, STB, Orchid        TSENG
  76.   Quadram, Sota, Willow
  77.   ---------------------------------------------------------------------
  78.   Trident, Logix, ZyMOS            TRIDENT
  79.   TrueTech
  80.   ---------------------------------------------------------------------
  81.   Video 7, Headland                VIDEO7
  82.   ---------------------------------------------------------------------
  83.   Generic VGA                      VGA
  84.   ---------------------------------------------------------------------
  85.   Tseng 4000, Sigma                TSENG4K
  86.   ---------------------------------------------------------------------
  87.   Genoa 6400/6600                  GENOA
  88.   ---------------------------------------------------------------------
  89.   V.E.S.A Driver                   VESA
  90.   ---------------------------------------------------------------------
  91.   Ahead Wizard Deluxe              AHEADB (older cards AHEADA)
  92.   ---------------------------------------------------------------------
  93.   Tecmar ADGM                      TECMAR (no auto-detect)
  94.   ---------------------------------------------------------------------
  95.   Trident 8900                     TRIDENT89 (no auto-detect)
  96.   ---------------------------------------------------------------------
  97.   Disk File image GIFDESK.DAT      FILE (no auto-detect)
  98.  
  99. Example:
  100.     If you have an AST VGA card (with 512k!) use the following command:
  101.     c:>SET GIFDESK=PARADISE
  102.  
  103. Notes: 1) The startup screen will notify you of the driver GIFDESK is using.
  104.       (the drivers are built into GIFDESK)
  105.        2) Several of the SVGA cards have not been tested...comments???
  106.       (Everex, Dell, Tecmar)
  107.  
  108.  
  109. Keys in GIFDESK:
  110.    "PgDn/PgUp" . .Next/Previous screen
  111.    "Esc" . . . . .Exit to DOS
  112.    "Space" . . . .Toggle Resolution (2x2->1x1->6x5->3x3->2x2...)
  113.    "Tab" . . . . .Skip to Next Pic
  114.    "." . . . . . .Write screen to GIF file
  115.    "Home". . . . .Go to first screen
  116.    "End" . . . . .Go to last screen
  117.    "+" . . . . . .Increase Resolution (SVGA only) (640x480->800x600->1024x768)
  118.    "-" . . . . . .Decrease Resolution (SVGA only) (1024x768->800x600->640x480)
  119.    "F9". . . . . .Print to LaserJet on LPT1
  120.    "F10. . . . . .Toggle between grey and colour mode (SVGA only)
  121.    "F1,F2,F3,F4. .Change directly to 1x1,2x2 etc.
  122.    any other . . .Skip to GIF file with name starting with character
  123.  
  124. Examples:
  125.    Key    Result
  126.    ===    ===========================================
  127.     .     Writes GIF file (named GIFDSKnn.GIF)
  128.     c     Skips to first GIF file starting with c (e.g. CHEAPSEX.GIF)
  129.     7       "   "    "    "   "      "      "   7 (e.g. 7HEAVEN.GIF)
  130.    end    Displays last set of GIF's (e.g ZAGNUT.GIF, ZIGGY.GIF, ...)
  131.    esc    Exit the wonderful world of GIFDESK
  132.  
  133. -------------------------------------------------------------------------------
  134. COMMAND FILE:
  135.     If the file GIFDESK.CMD is present in the current directory,
  136.     GIFDESK will read its commands from it. The file contains ASCII
  137.     commands that tell GIFDESK what to do next. This may be useful
  138.     to someone incorporating GIFDESK into an automatic GIF catalog
  139.     generator for BBS use.
  140.     SAMPLE.CMD contains a sample of a command file, along with a list of
  141.     available commands. To use it:
  142.         1) copy SAMPLE.CMD to GIFDESK.CMD
  143.         2) run GIFDESK... e.g. "GIFDESK *.gif"
  144.         3) watch it happen (its like a slide show)
  145.  
  146. -------------------------------------------------------------------------------
  147. FILE DRIVER:
  148.     This driver is activated by setting GIFDESK=FILE. No graphics
  149.     card is necessary; pixel operations are simulated by reading
  150.     and writing a disk file (GIFDESK.DAT). Printing is not
  151.     supported with this driver. Disk space of 768 kbytes is
  152.     required for the GIFDESK.DAT file. Normal keystrokes or Command
  153.     mode can be used (via the GIFDESK.CMD file, see SAMPLE.CMD).
  154.     Status information is directed to the screen during processing,
  155.     and can be redirected at command time:
  156.         C:>GIFDESK *.gif >lpt1
  157.     Note that this driver is slower than real hardware, and certain
  158.     operations (e.g. clearing the screen) may take a few seconds
  159.     and be disk intensive. GIF89a extensions are not supported for
  160.     this driver.
  161. ----------------------------------------------------------------------------
  162. COMMAND LINE OPTIONS:
  163.     -Vcard    forces use of card type video.         e.g. -VTSENG
  164.     -Rres     sets initial arrangement. 1=1x1, etc.  e.g. -R3
  165.     @file     read file names from "file"            e.g. @C:\biglist
  166. ----------------------------------------------------------------------------
  167. HiColor Notes:
  168.     GIF files currently support 8 bits per gun (red,green,blue),
  169.     256 triplets per image. This "palette" works well when displaying 1
  170.     image on a 256 color VGA screen even though VGA only has 6 bits per
  171.     gun. HiColor doesn't have a palette. It allows 32768 different colors
  172.     to be displayed all at once. When displaying one GIF file this isn't
  173.     an improvement as now the limit is 5 bits per gun. But when displaying
  174.     more than one GIF (like GIFDESK does) HiColor provides a great improve-
  175.     ment over normal VGA and Super-VGA. Now each picture can get its entire
  176.     set of colors without having to "share" with other pictures on the
  177.     same screen.
  178.     When you save a GIF file from a HiColor screen you will notice the file
  179.     (when redisplayed) is not up to par with the original screen. This is
  180.     due to the GIF file format limitation of 256 colors per image. Maybe
  181.     I'll add support for a different format save later like TIFF, JPEG,
  182.     or PCX.
  183. ----------------------------------------------------------------------------
  184.  
  185. Version History:
  186.     1.0 - Initial release, worked...kinda slow...
  187.     1.1 - Faster.
  188.       Allows keys during GIF decode.
  189.       Shows resolution even in 6x5 format.
  190.     2.0 - Super VGA support, promo screen, 1x1,2x2 format, better sizing!,
  191.       Writes GIF's!, 1st character key->filename, much more!
  192.     3.0 - Autodetect of SVGA.  Colour-colour-colour!!! (on SVGA, GIFDESK now
  193.       shows GIFs in colour in all modes.  Can still force to grey with
  194.       F10).  Fixed 640x480x256 for C&T, Paradise, Trident, & Video 7.
  195.     3.1 - Some intermediate beta releases
  196.     3.2 - Tseng 4000 support, clear screen routine changed, vertical
  197.       interrupt detection modified.
  198.     3.2a- GIF89a support, bank 0 preset fix for certain TSENG based
  199.       cards.
  200.     4.0 - Rewritten video drivers. Printing to LaserJet. VESA, Genoa,
  201.       Ahead, Tecmar, Trident 8900 added. Command file support. 16
  202.       color palette bug fix. FILE driver. More than 256 files quick
  203.       key bug fix. Better color selection per picture. Better
  204.       alphabetic file sorting. Full GIF89a support added.
  205.     4.1 - Fix of bug in file name generation after saving 10 GIF files.
  206.       Fix of bug in palette fix after lots of files displayed.
  207.       Fix of bug of lost error message upon exit.
  208.     4.2 - Addition of command line options (-V, -R, and @file). Addition of
  209.       several script commands.
  210.     4.3 - Addition of HiColor (32k) via VESA support. Tested on Diamond
  211.       Speedstar 24X card. Fixed minor printing bug.
  212.     4.4 - bug fixes for: Hicolor printing, command file IFEND
  213.     4.5 - VESA bug fixed for cards returning more than 256 bytes of info.
  214.  
  215. GIF is a trademark of CompuServe Inc.
  216.  
  217. Have comments, suggestions, fan mail, hate mail, GIF pictures?
  218.     Jay Wherley
  219.     2291 Grand Teton Blvd.
  220.     Melbourne, FL 32935
  221.  
  222.     Prodigy: CVFP18A
  223.     Compuserve: 72441,3326
  224.     Internet: jrw@ccd.harris.com
  225.  
  226. Finally, GIFDESK Was free, Is free, Always free.
  227.